4. Methods and Callbacks

4.06 On ShapeChange

Syntax:
On ShapeChange shapeID, linkstr
End

Purpose:
This callback is provided when the contents below the mouse cursor changes its kind.

When the user moves the mouse this movement is tracked. As soon as the content type below the mouse cursor changes, this event is sent. Usually You will use the callback to chage the mouse cursor depending on the context below, for example switch to a pointing hand, while the mouse is over a link.

shapeID is an integer value indicating the context type below the cursor

shapeID has one of the following values:

• -1: the mouse left the #html sprite
• 0: the mouse is over an empty space
• 1: the mouse is over a text area
• 2: the mouse is over a link
• 3: the mouse is over the scrollbars

linkstr is a string with the contents of the HREF attribute, while the mouse is over a link. If the mouse is not over a link (shapeID<>2) linkstr is an empty string

Note:

• As the event is handled with the next frame / frame loop, there is a delay depending on the frame rate. If the frame rate is too low - espacially on slow machines - some of the events may be not handled soon enough.
• Due to the way, director handles callbacks from Xtras, it is not possible to "go" to another movie from inside a "on shapechange" handler. This will lead to a crash.